package cn.tedu.ems.mapper;

import cn.tedu.ems.pojo.entity.News;
import cn.tedu.ems.pojo.vo.NewsListItemVO;
import cn.tedu.ems.pojo.vo.NewsStandardVO;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;

import java.util.List;

/**
 * 处理新闻数据的Mapper接口
 */
@Repository
public interface NewsMapper {
    /**
     * 添加新闻
     *
     * @param news 新闻数据
     * @return 受影响的行数
     */
    int insert(News news);

    /**
     * 批量添加新闻
     *
     * @param newsList  若干条新闻的集合
     * @return 受影响的行数
     */
    int insertBatch(List<News> newsList);

    /**
     * 根据id删除新闻
     *
     * @param id 新闻id
     * @return 受影响的行数
     */
    int deleteById(Long id);

    /**
     * 批量删除新闻
     *
     * @param ids 需要删除的若干条新闻的id
     * @return 受影响的行数
     */
    int deleteByIds(Long[] ids);

    /**
     * 根据新闻id修改新闻数据
     *
     * @param news 封装了新闻id和新数据的对象
     * @return 受影响的行数
     */
    int update(News news);

    /**
     * 统计新闻表中新闻的数量
     *
     * @return 新闻表中新闻的数量
     */
    int count();

    /**
     * 统计当前表中非此新闻id的匹配标题的新闻数据的数量
     *
     * @param id 当前新闻id
     * @param title 新闻标题
     * @return 当前表中非此新闻id的匹配标题的新闻数据的数量
     */
    int countByTitleAndNotId(@Param("id") Long id, @Param("title") String title);
    
    /**
     * 根据文章标题统计新闻的数量
     *
     * @param title 文章标题
     * @return 新闻表中新闻的数量
     */
    int countByTitle(String title);

    /**
     * 根据作者名称统计新闻的数量
     *
     * @param author 作者名称
     * @return 新闻表中新闻的数量
     */
    int countByAuthor(String author);

    /**
     * 根据投稿部门统计新闻的数量
     *
     * @param submissionDepartment 投稿部门
     * @return 新闻表中新闻的数量
     */
    int countBySubmissionDepartment(String submissionDepartment);

    /**
     * 根据投稿栏目统计新闻的数量
     *
     * @param submissionColumn 投稿栏目
     * @return 新闻表中新闻的数量
     */
    int countBySubmissionColumn(String submissionColumn);

    /**
     * 根据id查询新闻的详情
     *
     * @param id 新闻id
     * @return 匹配的新闻详情，如果没有匹配的数据，则返回null
     */
    NewsStandardVO getStandardById(Long id);

    /**
     * 根据投稿标题查询新闻的详情
     *
     * @param title 投稿标题
     * @return 匹配的新闻详情，如果没有匹配的数据，则返回null
     */
    NewsStandardVO getStandardByTitle(String title);

    /**
     * 查询新闻列表
     *
     * @return 新闻列表
     */
    List<NewsListItemVO> list();

    /**
     * 根据文章标题查询新闻列表
     *
     * @param title 投稿标题
     * @return 新闻列表
     */
    List<NewsListItemVO> listByTitle(String title);

    /**
     * 根据文章作者查询新闻列表
     *
     * @param author 作者名称
     * @return 新闻列表
     */
    List<NewsListItemVO> listByAuthor(String author);

    /**
     * 根据投稿部门查询新闻列表
     *
     * @param submissionDepartment 投稿部门
     * @return 新闻列表
     */
    List<NewsListItemVO> listBySubmissionDepartment(String submissionDepartment);

    /**
     * 根据投稿栏目查询新闻列表
     *
     * @param submissionColumn 投稿栏目
     * @return 新闻列表
     */
    List<NewsListItemVO> listBySubmissionColumn(String submissionColumn);
}
